*V1.1初版 appendtxts 的帮助文件框架

*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
*
*help appendfiles                                                                                                                               
*-----------------------------------------------------------------------------------------------------------------------------------------------
*
*Title
*
*
*    appendfiles -- Appends all .txt files in the specified directory.
*
*
*Syntax
*
*        appendfiles directory [,saving(path\filename)]
*
*
*Description
*
*    directory is a valid specified directory that contains .txt files.
*    All .txt files in the specified directory would be appended in the order of their names.
*    The option saving() allows users to specify the name and the saving folder of the generated .txt file.
*
*
*Option
*
*    saving(path\filename): specify the name and the saving folder of the generated .txt file.
*    Users do not need to specify the filename with the extension ".txt". The appendtxts would automatically generate the file in .txt format.
*    The default filename of the generated .txt file is "appendtxts_output.txt", and the default saving folder is the specified input
*    directory.
*    Users could specify the saving folder by adding the directory before the filename. The string after the last "\" in the
*    saving(path\filename) would be recognized as the filename
*    If users only specify the filename without the saving folder, the default saving folder is the input directory.
*
*
*
*Examples
*
*    appendtxts D:\example
*    Appends every .txt file in the directory "D:\example". The saving folder is the same as "D:\example", and the name of the generated file
*    is "appendtxts_output.txt"
*
*    appendtxts D:\example, saving(newtxtfile)
*    Appends every .txt file in the directory "D:\example". The saving folder is the same as "D:\example", and the name of the generated file
*    is "newtxtfile.txt"
*
*    appendtxts D:\example, saving(D:\output\newtxtfile)
*    Appends every .txt file in the directory "D:\example". The saving folder is "D:\output", and the name of the generated file is
*    "newtxtfile.txt"
*
*
*
*Authors
*
*    Yujun Lian (Arlion)
*        Department of Finance, Lingnan College, Sun Yat-Sen University.
*        E-mail: arlionn@163.com.
*
*    Zhonghao Wei
*        Lingnan College, Sun Yat-Sen University.
*
*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@










{smcl}
{* 10 Jan 2019}{...}
{cmd:help appendtxts}{right: }
{hline}

{title:Title}


{phang}
{bf:cntrade} {hline 2} Appends all .txt files in the specified directory.


{title:Syntax}

{p 8 18 2}
{cmdab:appendtxts} {it:directory} [,{it:saving(path\filename)}]


{marker description}{...}
{title:Description}

{pstd}{it:directory} is a valid specified directory that contains .txt files. {p_end}
{pstd} All .txt files in the specified directory would be appended in the order of their names. {p_end}
{pstd} The option {it:saving()} allows users to specify the name and the saving folder of the generated .txt file. {p_end}


{marker options}{...}
{title:Option}

{phang}
{it:saving(path\filename)}: specify the name and the saving folder of the generated .txt file. {p_end}
{pstd} Users do not need to specify the filename with the extension ".txt". The appendtxts would automatically generate the file in .txt format. {p_end}
{pstd} The default filename of the generated .txt file is "appendtxts_output.txt", and the default saving folder is the specified input directory. {p_end}
{pstd} Users could specify the saving folder by adding the directory before the filename. The string after the last "\" in the {it:saving(path\filename)} would be recognized as the filename {p_end}
{pstd} If users only specify the filename without the saving folder, the default saving folder is the input directory. {p_end}



{title:Examples}

{pstd} appendtxts D:\example {p_end}
{pstd} Appends every .txt file in the directory "D:\example". The saving folder is the same as "D:\example", and the name of the generated file is "appendtxts_output.txt" {p_end}

{pstd} appendtxts D:\example, saving(newtxtfile) {p_end}
{pstd} Appends every .txt file in the directory "D:\example". The saving folder is the same as "D:\example", and the name of the generated file is "newtxtfile.txt" {p_end}

{pstd} appendtxts D:\example, saving(D:\output\newtxtfile) {p_end}
{pstd} Appends every .txt file in the directory "D:\example". The saving folder is "D:\output", and the name of the generated file is "newtxtfile.txt" {p_end}



{title:Authors}

{phang}
Yujun Lian (Arlion) {break}
Department of Finance, Lingnan College, Sun Yat-Sen University. {break}
E-mail: {browse "mailto:arlionn@163.com":arlionn@163.com}.
{p_end}

{phang}
Zhonghao Wei {break}
Lingnan College, Sun Yat-Sen University. {break}
E-mail: {browse "mailto:wwwwwxiaowei@163.com":wwwwwxiaowei@163.com}.
